home *** CD-ROM | disk | FTP | other *** search
/ Gamers Delight 2 / Gamers Delight 2.iso / Aminet / game / role / itf160.lha / Amiga.txt next >
Text File  |  1994-10-18  |  21KB  |  465 lines
  1. The InfoTaskForce Infocom Interpreter Version 4.01
  2. ==================================================
  3.  
  4. Amiga Release 1.60 by David Kinder
  5. ==================================
  6.  
  7. Fed up of the rather crude official Infocom interpreters? Annoyed that "The
  8. Lost Treasures of Infocom II" wasn't released for the Amiga? Then read on...
  9.  
  10. There have been several ports of Infocom interpreters to the Amiga, but none
  11. of this program. The interpreter supports v1, v2, v3 (Zork1 to Stationfall),
  12. v4 (Trinity, Bureaucracy, etc.) and v5 (Sherlock, Beyond Zork, etc.) games.
  13. With this interpreter you can play ALL the games in the 3.5" disk LToI2
  14. package for the IBM PC, by copying the datafiles with CrossDOS or similar,
  15. then just running this interpreter. This program requires AmigaDOS 2.04 or
  16. higher to run.
  17.  
  18. As far as I am aware, as of Release 1.40, this interpreter supports all the
  19. features of Infocom data files relevant to the Amiga, including the "Undo"
  20. command (in such games as choose to implement it). If you find otherwise,
  21. please let me know.
  22.  
  23. Infocom Startup
  24. ===============
  25.  
  26. Infocom can be started with a game file by clicking on the Infocom icon and
  27. then shift double clicking on the game file icon. Alternatively, if the game
  28. file's default tool has been set to where Infocom is, double clicking on the
  29. game file icon will load Infocom and run the game.
  30.  
  31. The following can be added to the ToolTypes field of the Infocom icon (not
  32. game file icons):
  33.  
  34.     ATTRIBUTES    - equivalent to the -a command line switch
  35.     PRELOAD    - equivalent to the -l command line switch
  36.     NOPAGING    - equivalent to the -p command line switch
  37.     TRANSFER    - equivalent to the -t command line switch
  38.     BZCOLOURS    - use "Beyond Zork" colour scheme with the graphics file.
  39.           The synonym "BZCOLORS" is also accepted. Equivalent to
  40.           the -z command line switch.
  41.  
  42. If the Infocom icon is double clicked (i.e. no game file selected), Infocom
  43. scans the assignment INFOCOM: (and its sub-directories) for valid Infocom
  44. game files. To speed up scanning, files are ignored unless their name
  45. matches the AmigaDOS pattern (~(#?.#?)|#?.(dat#?|z?)). This means that only
  46. files with no extension, or files ending with .data (Amiga story files) or
  47. .dat (PC story files) or .z3 or .z5 (files produced by the Infocom format
  48. compiler Inform) are scanned.
  49.  
  50. Using the InfoPrefs editor (see below), further directories to be searched
  51. can be defined, and also directories to be ignored if the scan reaches them.
  52. If Infocom cannot find one of the further directories specified, the
  53. directory will not be searched and no "Please Insert Volume..." requester
  54. will appear. Whether INFOCOM: is searched at all before these other
  55. directories or not, and whether or not a "Please Insert Volume..." requester
  56. appears if INFOCOM: cannot be found can be defined in InfoPrefs.
  57.  
  58. After searching is complete, a list of all the games found will appear. The
  59. action taken by Infocom on finding multiple copies of the same game can be
  60. altered in InfoPrefs. The default action is to display all games that have
  61. been found. If more than one version of the game is found, the serial number
  62. will be displayed in brackets after the game name. Other available actions
  63. are to only display different versions or only to display the first found
  64. version of each game.
  65.  
  66. Click on the game you want to play and it will load and run. If you click on
  67. a game while holding down the shift key a requester will appear indicating
  68. the name of the game, its release and serial numbers, and the full path to
  69. the game file. At the bottom of this list is a "Select with File Requester"
  70. gadget. Clicking on this gadget opens a file requester with which you can
  71. select the game to play. This list can also be made to appear by starting
  72. Infocom from the Shell with the -w switch. Note that this must be the only
  73. argument, i.e.
  74.  
  75.     Infocom -w
  76.  
  77. is the only valid use of this switch.
  78.  
  79. The "Infocom" Display
  80. =====================
  81.  
  82. If Infocom opens on its own screen, the screen clones the Workbench screen
  83. to use its size, resolution and fonts (unless selections have been made for
  84. these in InfoPrefs). If possible, the Infocom screen is public, with the
  85. name "Infocom".
  86.  
  87. Pressing the Help key gives the game currently playing, its author and
  88. difficulty level (where available), and the screen type (public, private,
  89. etc.).
  90.  
  91. Version 3 games can be played using a proportional font (specified in
  92. InfoPrefs). If no version 3 font is specified, the fixed width window font
  93. will be used.
  94.  
  95. Left and right margins can be used (set in InfoPrefs) so that the text is
  96. not flush with the screen border. This can be useful to make the text more
  97. readable if you are using a program to give screens black borders. The
  98. status line of most Infocom games will extend across the screen regardless
  99. of the margin settings.
  100.  
  101. The current line can be edited using backspace, delete, and the left and
  102. right cursor keys. The shifted cursor keys move the cursor to the beginning
  103. and end of the current line, respectively.
  104.  
  105. Input lines have a history buffer. Use cursor up and down to scroll through
  106. the buffer, and shift cursor up and down to go to the top and bottom of the
  107. buffer, respectively.
  108.  
  109. File Operations
  110. ===============
  111.  
  112. If asl.library is available, Infocom uses the file requester to prompt for
  113. any file names required. For Save and Restore operations, the default name
  114. is the name of data file, minus any extensions and with ".Save" appended.
  115.  
  116. If the project icon Icon.Data is present in the same directory as Infocom,
  117. saved game files have this icon when Infocom is started from Workbench.
  118.  
  119. The Script command causes a window to open. In the window the user can
  120. choose the file to which the script should be sent by either typing it into
  121. the string gadget, or click on the "Req" gadget, which causes a file
  122. requester to open. This allows the script to be sent to a device that does
  123. not appear in the file requester, e.g. PRT:.
  124.  
  125. Support for Specific Games
  126. ==========================
  127.  
  128. 1) "The Lurking Horror"
  129.  
  130.    Sound files are supported, as distributed with the Amiga release. Copy
  131.    all the sound files to the subdirectory Sound in the directory containing
  132.    the Lurking Horror data file, e.g.
  133.  
  134.     DataFiles/LurkingHorror        <- data file
  135.     DataFiles/Sound/s#?.dat        <- sound files
  136.     DataFiles/Sound/s#?.mid
  137.  
  138. 2) "Border Zone"
  139.  
  140.    "Border Zone" implements an internal clock which is constantly running,
  141.    regardless of whether you type in commands or not. Thus events take place
  142.    without the user doing anything.
  143.  
  144. 3) "Beyond Zork"
  145.  
  146.    Infocom can use the graphics file "Graphics.data", which was part of the
  147.    original Amiga release of "Beyond Zork", and was also included in the
  148.    Amiga version of "The Lost Treasures of Infocom I". Copy the file to
  149.    where the "Beyond Zork" data file is kept. The file may be renamed to
  150.    "BeyondZork.gfx". Use of the graphics file requires that the window text
  151.    is an 8×8 non-proportional font. If the font does not match these
  152.    characteristics, then topaz/8 will be used instead.
  153.  
  154.    If the graphics file is present, the interpreter can use the "Beyond
  155.    Zork" colour scheme. This feature is activated by the -z command line
  156.    switch or the "BZCOLOUR" icon tooltype, or by InfoPrefs. The colour
  157.    scheme can then be changed in the game with the "color" command.
  158.  
  159.    The arrow keys can be used to select items in the startup menus.
  160.  
  161.    The function keys are preloaded with commands, which can be changed from
  162.    within the game with the "define" command.
  163.  
  164.    The numeric keypad and the mouse can be used to select a direction. To
  165.    use the mouse, click in the map to indicate the direction you wish to
  166.    move in.
  167.  
  168. Special Commands
  169. ================
  170.  
  171. The debugging commands present in some games are supported. These are
  172. #record, #unrecord and #command (#reco, #unre and #comm in version 3 games).
  173.  
  174. #record prompts for a file name, to which all user input is sent until the
  175. command #unrecord is issued. This recording of the user's actions can be
  176. replayed with #command, which prompts for a file name to play back.
  177.  
  178. Also, the command "Undo" (present in some version 5 games), which takes back
  179. the player's last move, is supported.
  180.  
  181. The "Infocom.games" File
  182. ========================
  183.  
  184. The list of games recognized by Infocom can be extended using the
  185. "Infocom.games" file, which can be either in the startup directory or in
  186. S:. The format of this file is e.g.
  187.  
  188. [Zork I: The Great Underground Empire]    <- The game name enclosed in [].
  189. Author=Marc Blank & Dave Lebling    <- The game's author, optional.
  190. 25 / 820515                <- A list of the release and
  191. 28 / 821013                   serial numbers for each version
  192. 30 / 830330                   of the game (Which can be found
  193. 75 / 830929                   for any game file using the -h
  194. 76 / 840509                   option.) as the release number,
  195. 88 / 840726                   followed by a / and then the
  196. 52 / 871125                   serial number.
  197.  
  198. [Zork II: The Wizard of Frobozz]
  199.  
  200. ... and so on.
  201.  
  202. Now any game included in this file will appear in the initial game list
  203. (provided the game is present) and it's name and author will appear in the
  204. Help key requester.
  205.  
  206. Standard I/O Option
  207. ===================
  208.  
  209. Infocom uses standard input/output if the -c switch is specified at the
  210. Shell. This allows Infocom to e.g. take input from a file, or to be used
  211. over a network. In the latter case, the output terminal must support ANSI
  212. 3.64 character sequences. Infocom will exit in this mode if it receives a
  213. CTRL-C break.
  214.  
  215. The default size of the window and colour of the text can be changed by
  216. specifying the with, height and pen number after "-c", each separated by a
  217. forward slash, e.g.
  218.  
  219.     Infocom -c70/20/2 Zork1
  220.  
  221. starts "Zork I" in a character window of width 70 and height 20, with all
  222. text using pen 2. Note that the values are the size of the window Infocom
  223. expects - the actual output window of your terminal or Shell must be at
  224. least as big as these values.
  225.  
  226. If one or more of the values are not specified, the appropriate default is
  227. used, so e.g.
  228.  
  229.     Infocom -c70/20 Zork1    or
  230.     Infocom -c//2 Zork1        is valid.
  231.  
  232. If you use a CON: window for input, then you will notice functions which use
  233. an individual key press (e.g. scrolling up and down the list of hints in
  234. "Sherlock") behave slightly differently. CON: windows only pass input to the
  235. program after return is pressed, so if the program is expecting single key
  236. presses, entering 'q' and pressing return causes the program to see a 'q'
  237. character followed by a return character. If, say, you wish the program to
  238. see two 'q' characters in a row, to e.g. quit out of a hint screen after
  239. reading a hint, enter 'qq' followed by return.
  240.  
  241. For use over e.g. a network, Infocom can restrict the user's actions. This
  242. is done by specifying a filename to be used for loading and saving games, in
  243. conjunction with the -c option. The name of the file to use for loading and
  244. saving should be given as the third argument, e.g.
  245.  
  246.     Infocom -c Zork1 Saved:Zork1.Save
  247.  
  248. This also disables any file writing functions other than the loading and
  249. saving of games, and also stops CTRL-C exiting Infocom. Futhermore, the -m
  250. switch can be used with in this situation to set a time limit for any user
  251. playing a game. The format for -m is the time allowed in minutes, optionally
  252. followed by one or two times at which the user should be warned of the time
  253. remaining, e.g.
  254.  
  255.     Infocom -c/70/20m60/5/1 Zork1 Saved:Zork1.Save
  256.  
  257. allows the user to play Zork1 for sixty minutes, with warnings when there
  258. are five minutes and one minute left. Both warnings are optional, so both
  259.  
  260.     Infocom -cm60 Zork1 Saved:Zork1.Save
  261.     Infocom -cm60/5 Zork1 Saved:Zork1.Save
  262.  
  263. are valid.
  264.  
  265. "InfoPrefs" - The Infocom Preferences Editor
  266. ============================================
  267.  
  268. Many options in the interpreter can be defined using the external
  269. configuration editor, InfoPrefs, which requires that either asl.library v38
  270. or higher or reqtools.library v38 or higher is in LIBS:. By default,
  271. reqtools.library is only used if asl.library v38+ is not available, but this
  272. can be over-ridden with the icon tooltype REQTOOLS, or by the Shell option
  273. of the same name (i.e. 1> InfoPrefs REQTOOLS). The configuration is stored
  274. in the environment variable "Infocom.prefs", which is read in by Infocom at
  275. startup. InfoPrefs allows you to change:
  276.  
  277.   Beyond Zork Colours    - If checked, "Beyond Zork" uses its custom colour
  278.               scheme.
  279.   Pre-Load Data Files    - If checked, the whole data file is loaded at the
  280.               start, rather than only needed sections being
  281.               loaded.
  282.   Use Workbench Screen    - If checked, the interpreter opens a Workbench
  283.               window rather than its own screen.
  284.   Custom Window Size    - If checked, and if "Use Workbench Screen" checked,
  285.               then the Workbench window size is taken from the
  286.               values entered below rather than chosen by the
  287.               program.
  288.   Left Edge, Top Edge,    - Determine the dimensions (in pixels) of the
  289.   Width, Height          Workbench window used by Infocom if both the above
  290.               gadgets are checked.
  291.   L. Margin, R. Margin    - The size (in characters) of the left and right
  292.               margins to be used.
  293.   StdIO Width, Height    - The default size (in characters) of the character
  294.               window to be used in StdIO mode (-c command line
  295.               option).
  296.   Screen Font        - Opens a font requester from which to choose the
  297.               screen font to use.
  298.   Screen Colours    - Opens a palette requester with which to choose the
  299.               screen colours. This option requires
  300.               reqtools.library to work.
  301.   Screen Mode        - The mode and depth of the screen Infocom is to
  302.               open.
  303.   Window Fonts        - There are two window fonts - one is a fixed width
  304.               font used for version 4 and higher games, and the
  305.               second is used for version 3 or lower games. The
  306.               second font may be proportional.
  307.   Use Settings        - Writes the chosen settings to "ENV:Infocom.prefs".
  308.               The settings remain in effect until the computer
  309.               is reset.
  310.   Save Settings        - Writes the chosen settings to "ENV:Infocom.prefs"
  311.               and "ENVARC:Infocom.prefs". The settings are made
  312.               permanent.
  313.  
  314.   Games List        - This causes a new window to open, containing
  315.               parameters affecting the list of games displayed
  316.               at startup. The available options are:
  317.  
  318.   File to be displayed    - Choose whether Infocom displays all games found,
  319.               only different versions of a game, or only the
  320.               first version of each game.
  321.   Ask for INFOCOM:    - If selected, and the INFOCOM: assignment cannot be
  322.               resolved, a "Please Insert Volume..." requester
  323.               will appear. If this is not selected, no such
  324.               requester will appear.
  325.   Search INFOCOM:    - If selected (this is the default), the assignment
  326.               INFOCOM: is searched before any directories
  327.               specified below. If this is not selected, INFOCOM:
  328.               will not be searched, so that only games in
  329.               directories specified in the Search ListView will
  330.               appear in the startup list.
  331.   Search directories    - Allows the selection of directories other than
  332.               INFOCOM: to be searched for game files. Select
  333.               "Add" to add a new entry, which can then be
  334.               edited in the string gadget. Current entries can
  335.               be edited by clicking on them in the list. The
  336.               "Del" gadget deletes the current entry, and the
  337.               "Req" gadget changes the current entry to the
  338.               directory selected in the file requester which
  339.               appears.
  340.   Exclude directories    - As above, but allows the selection of directories
  341.               that are not to be searched. If, in searching
  342.               directories and sub-directories, Infocom finds
  343.               a directory named in this list, the directory is
  344.               not searched. For this reason, entries in this
  345.               list should not contain device names, i.e.
  346.  
  347.                 Games:Zork1  and not e.g.  DF0:Zork1
  348.  
  349. Finally
  350. =======
  351.  
  352. If you find any bugs, please let me know. In particular, the program
  353. contains an internal list of all release and serial numbers of released
  354. games. If you have a game file which plays correctly, but its correct title
  355. does not show up in the Workbench startup list or in the Help requester,
  356. please tell me its release and serial numbers (obtainable with the -h
  357. command line option).
  358.  
  359. Internet Email: kinder@teaching.physics.ox.ac.uk
  360.         or    david.kinder@physics.ox.ac.uk
  361.  
  362. Postal mail:    David Kinder,
  363.         2, Clwtt Cottages,
  364.         Bangor Road,
  365.         Gyfelia,
  366.         Nr. Wrexham,
  367.         Clywd.
  368.         LL13 0YL
  369.  
  370. History
  371. =======
  372.  
  373. 1.00    * First release.
  374.  
  375. 1.10    * Added support for icon tooltypes.
  376.     * If Workbench screen is larger than physical display, Infocom
  377.       screen is kept to size of physical display.
  378.     * Saved games can have icons if "Icon.Data" icon present.
  379.     * A "Strike any key to exit." prompt appears if there is text to
  380.       be read before the game quits.
  381.     * Public screen opened if possible.
  382.     * Save/Restore uses asl.library if available.
  383.     * Better error reporting from Workbench.
  384.     * Scripting in "AMFV" fixed.
  385.     * Initial game list ignores files with ".#?" extensions except
  386.       ".data". List now also looks in sub-directories of INFOCOM:
  387.       for game files.
  388.     * Initial game list has gadget to allow file requester to be
  389.       used to select the game file to load.
  390.     * Lines of text longer than the screen are handled better.
  391.     * Fixed problems with a Workbench output window appearing if
  392.       ConMan was running.
  393.     * Input text is printed in a different colour to output.
  394.     * Arrow keys now work (as used in "Beyond Zork").
  395.  
  396. 1.20    * Graphics in "Beyond Zork" supported.
  397.     * Input line history buffer.
  398.     * Better input line editing.
  399.     * Output routines buffered - text printing is now *much* faster.
  400.  
  401. 1.30    * Scripting should now work in all "AMFV" versions.
  402.     * Debugging commands #record, #unrecord and #command implemented.
  403.     * Problems with scripting and line editing fixed.
  404.     * Options read from "ENV:Infocom.prefs", which can be edited using
  405.       the InfoPrefs program.
  406.     * "Beyond Zork" now has support for different colour schemes, if
  407.       the graphics data file is available. Also, the "color" command
  408.       works correctly.
  409.     * The function keys in "Beyond Zork" are now fully supported. The
  410.       commands on the function keys can be changed in the game with
  411.       the "define" command.
  412.  
  413. 1.40    * Scanning through input line history is much faster.
  414.     * The -h option prints more information on version 5 games.
  415.     * Updated documentation on version 5 header and data flags.
  416.     * The numeric keypad and mouse now work in "Beyond Zork".
  417.     * The interpreter can now run in a Workbench window.
  418.     * InfoPrefs options extended.
  419.     * "Border Zone" internal clock implemented - the game time
  420.       progresses even without the intervention of the player.
  421.     * Improved handling of lines of text longer than the screen.
  422.  
  423. 1.45    * Problem of a "Lurking Horror" data file being incorrectly
  424.       recognised is now fixed.
  425.     * Switched compilers from GNU C 2.2.2 to DICE 2.07.56R. The code
  426.       is now significantly shorter.
  427.     * Added standard input/output routines.
  428.     * Text can be offset from the screen edges by margins.
  429.     * Default screen colours can be set in InfoPrefs.
  430.     * New command line switch "-w" to display game files in INFOCOM:.
  431.  
  432. 1.50    * Removed miscellaneous bugs.
  433.     * Option to define saved game file with -c switch.
  434.     * Colour of stdio text can be changed with -c option.
  435.     * Defaults accepted in -c argument string.
  436.     * Version 3 games can now use proportional fonts for output.
  437.     * The version 3 status line extends across the display regardless
  438.       of any margins set.
  439.  
  440. 1.55    * Status line extends across the display for any Infocom game.
  441.     * Shift-clicking on a game in the initial list opens a requester
  442.       with information about the game file.
  443.     * The option of defining a saved game name with -c also disables
  444.       CTRL-C.
  445.     * "Infocom.games" file can be used to specify games that Infocom
  446.       should recognize.
  447.     * New options controlling the initial game list, which can be
  448.       altered from the new "Games List" window in InfoPrefs:
  449.        * Other directories to be searched can be defined.
  450.        * Directories to be ignored can be defined.
  451.        * List can display all games found, only different versions, or
  452.          only different games.
  453.        * If INFOCOM: is not found, whether or not a "Please Insert
  454.          Volume..." requester appears can be controlled.
  455.     * Fixed some minor problems with version 5 games produced with the
  456.       Infocom format compiler "Inform".
  457.  
  458. 1.60    * Fixed size of ListView gadgets in InfoPrefs under V40.
  459.     * Added "Search INFOCOM:" preferences option.
  460.     * New command line switch "-m" to be used with -c to set a limit
  461.       on the length of time spent playing a game.
  462.     * Debugging commands (#record, etc.) now use file requester.
  463.     * Scripting has a window into which script file can be entered, or
  464.       the file requester can be used.
  465.